From e1bc61af7621ee07f7ba03afcfa4b6fa54fbfb2a Mon Sep 17 00:00:00 2001 From: Wei Liu Date: Fri, 20 Oct 2017 17:30:41 +0100 Subject: [PATCH] docs: update coverage.markdown MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit The coverage support in hypervisor is redone. Update the document. Signed-off-by: Wei Liu Acked-by: Ian Jackson Reviewed-by: Roger Pau Monné --- docs/misc/coverage.markdown | 30 +++++++++--------------------- 1 file changed, 9 insertions(+), 21 deletions(-) diff --git a/docs/misc/coverage.markdown b/docs/misc/coverage.markdown index 9a88c899b8..6eae44176c 100644 --- a/docs/misc/coverage.markdown +++ b/docs/misc/coverage.markdown @@ -10,38 +10,26 @@ down your hypervisor. ## Enable coverage -Test coverage support can be turned on compiling Xen with the `coverage` option set -to `y`. +Test coverage support can be turned on compiling Xen with the `CONFIG_GCOV` +option set to `y`. -Something like: - - cd xen - make coverage=y - -(or change your `.config` file). +Change your `.config` or run `make -C xen menuconfig`. ## Extract coverage data -The way GCC and other tools deal with coverage information is to use some files -created during build phase (.gcno) and some files produced by executing the -*program* (.gcda). The program in this case is Xen but Xen cannot write files -so the way you can use coverage from Xen is extract coverage data from Xen and -then split these information into files. - -To extract data you use a simple utility called `xencov`. Mainly `xencore` -allows you to do 3 operations: +To extract data you use a simple utility called `xencov`. +It allows you to do 2 operations: * `xencov read` extract data * `xencov reset` reset all coverage counters -* `xencov read-reset` extract data and reset counters at the same time. -Another utility (`xencov_split`) is used to split extracted data file into files -needed by userspace tools. +Another utility (`xencov_split`) is used to split extracted data file into +files needed by userspace tools. ## Split coverage data -Once you extracted data from Xen, it is time to create files which the coverage tools -can understand. To do it you need to run `xencov_split` utility. +Once you extracted data from Xen, it is time to create files which the coverage +tools can understand. To do it you need to run `xencov_split` utility. The utility just takes an input file and splits the blob into gcc .gcda files in the same directory that you execute the script. As file names are generated -- 2.30.2